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Users should be aware that a software release bulletin | 
accompanies each software product ordered from Honeywell. Users 
should consult the software release bulletin before uSing the | 
software. Users should contact their Honeywell representative if 
a copy of the software release bulletin is not available. 
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Section 1 
OVER VIE W 


This section provides a general overview of the Data Base 
Augmented Real-Time Trace System (DARTS). 


DARTS is an online software trace facility available with MOD 
400 Executive and networking software. It is a field support and 
maintenance facility. 


DARTS FACILITY 


DARTS monitors the execution of a set of software modules 
operating under the MOD 400 system. The user defines and 
Operates Trace Information Points (TIPs) at specific sites within 
the modules in question. The user also builds a Trace 
Information Capture Specification (TICS) for each TIP so that 
specific information can be collected when the TIP executes. 


See Section 2 for a description of how DARTS monitors the 
flow of execution using TIPs and TICS. 


DARTS CONFIGURATION AND INITIALIZATION 

A Configuration Load Manager (CLM) LDBU directive is a 
prerequisite for using DARTS. Configuring MOD 400 activates the 
directive. When brought online DARTS requires a data base file; 
the data base file is processed during initialization. 

Section 3 and Appendix B provide detailed instructions for 
bringing DARTS online. | 
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COMMAND LANGUAGE 
The DARTS facility accepts commands from three sources: 
The initialization data base file 


» The operator console (interactive) 
- The XEC command file (noninteractive). 


W bo 


The format of a command is the same regardless of the 
source, The commands can be used to define and control the TICS, 
the DARTS buffer pool, and the logging and formatting operations. 


Sections 4 and 5 describe the command language in detail, 
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Section 2 
DARTS MONITOR 


TRACE INFORMATION POINTS 


A Trace Information Point (TIP) represents a user interface 
to the DARTS Data Collector. A TIP must be predefined and 
assembled in line with the user software. Each TIP must be 
identified by a unique hexadecimal four-digit (16-bit) number. 
The leading two digits (Module Code) cannot be 00. (Refer to 
Section 4 for allocated Module Codes.) A defined TIP without an 
associated Trace Information Capture Specification (TICS) is an 
inactive TIP. 


A set of internal buffers holds the data collected for each 
TIP in chronological order. The time-stamped data buffers are 
logged onto a disk file. 


Commands can be issued to the DARTS monitor from the 
operator's console. The user can issue commands to define new 
TICS, manipulate the execution of defined TICS, control the 
logging of the raw data (time stamped), and format the logged 
data. 


Format either online or offline; that is, either while the 


data collection takes place or after the data collection session 
has ended. oo | 
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Predefined TIPs and TICS 


A set of TIPs is predefined in some software modules. These 
TIPs are assembled inline, using one of the two interfaces 
described later in this section. The associated TICS are | 
specified by a set of standard DARTS user commands contained in 
data base files (see Appendix B) usually residing under the >>SID 
directory. | 


The information collected at the predefined TIPs allows 
software support personnel to view the operation of the software 
modules in question. By selective activation of these TIPs, 
information can be filtered at the time of collection, By. 
logging a minimum amount of raw data, the user can follow the 
flow of execution (and data) in chronological order across layers 
of software. 


DARTS FACILITY 
The DARTS monitor consists of the following components: 


Data Collector 
Command Manager 
Command Processors 
Data Buffer Manager 
Data Buffer Logger 
Log File Formatter. 


When invoked with an Operator Control Language (OCL) command, 
DARTS operates in the system pool (SS) in both distributed and 
nondistributed environments. DARTS can trace and format 
collected data only when invoked uSing an OCL command within 
DARTS. Optionally, DARTS can be invoked with an ECL command from 
a user task group acting strictly as the formatter of the 
specified log file. 


Data Collector 


When a TIP executes, the data collector is responsible for 
collecting data into one or more of the internal buffers 
maintained by DARTS. The collector operates in a distributed 
environment and executes at the level of the caller. The data 
collector uses the 16-bit TIP id to locate the associated TICS 
structure. From information in the TICS, the data collector 
determines whether or not data is to be collected, and the extent 
of the data to be collected. 


When a buffer is filled the data collector logs it. Data 


collection at a TIP takes place only when the logging operation 
is active. 
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User Interfaces to the Data Collector 


Two types of user interface to the data oCPeenoe are 
supported at a TIP: 


1. A general (trap) interface, available to all users, 
through a Trace instruction at a TIP. The Trace 
instruction (Z'1234') generates an illegal instruction 
trap (05) which is intercepted by a special trap handler 
to perform the trace function. 


2. A special (link-and-jump) interface, available only to 
system level modules for faster execution at a TIP. 
Users of this interface must supply a 64-word stack for 
the DARTS collector. 


Software operating in Ring 0 can use either interface, while 
software executing in Rings 1/2/3 is restricted to the general 
interface. 


Command Manager 


The command manager component of DARTS parses the interactive 
operator command entered from the system console and schedules 
the appropriate command processor. 


Interactive input is processed at the level of the DARTS 
(OCL) task. While individual DARTS commands can be issued by the 
operator interactively, putting individual DARTS commands into a 
data base file and issuing DARTS commmands via the XEC command 
(refer to Section 4) is recommended, 


Command arguments are parsed into a parameter block and 
passed to the specific command processor overlay, which is 
loaded, executed, and then unloaded. 


Command Processors 


Specific command processors are available as floatable 
overlays of the DARTS bound unit, to be loaded as necessary for 
one-time execution. A link-and-jump interface exists between the 
command manager and a command processor, 


Data Buffer Manager 


The data buffer manager maintains the chain of internal 
buffers and acquires additional buffers as the need arises. [It 
acts in concert with the data buffer logger as a nondistributed 
task, and is created as part of DARTS initialization. This task 
ends when DARTS terminates. 
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Data Buffer Logger 

| The data buffer iaaee processes all eapeens: scheauied by he: 
Data Collector. It writes the scheduled buffers to the log file 

in chronological order. It operates with the data buffer manager 


in a nondistributed environment, The data collector triggers the 
data buffer logger. oe ens | 


The data buffer logger operates on a file created PY a LOG 
command, 


Log File Formatter 


An interactive DARTS command schedules the log file 
formatter. The log file formatter formats the collected data and 
puts the data in designated log files. Command arguments allow 
for the processing of data collected in a specified time frame. 
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Section 3 


CONFIGURATION, 
INITIALIZATION, 
AND TERMINATION 


CONFIGURATION 


The DARTS facility can be used on a MOD 400 4.0 system only 
after a configuration component has been loaded by. the 
Configuration Load Manager (CLM). This is done implicitly, 
provided the bound unit, ZXDJ, is located under the >>SID 
directory. 


The configuration component contains the preprocessor of the 
data collector for the general and special interfaces of the 
DARTS Trace instructions. The preprocessor replaces minimal 
processor routines present in the Executive. 


The presence of the configuration component in a system is 
reflected in the System Control Block (SCB). At offset S DINF, 
DARTS sets bit 0 indicating that it has been configured (bit 0 
represents a mask of X'8000'). The template macro for the SCB 
(Z3SCB), contained in the OS LIB macro library, defines the 
offset S DINF. 7 | 


INITIALIZATION 


Initialize DARTS by an OCL command specifying an | : 
initialization data base file. The DARTS data collection . 
component, as well as the buffer manager component and buffer 
logger component, loads into the system as part of 
initialization. Upon completion of initialization, bit l of 
offset S DINF is set in SCB (mask of X'4000'). = 
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Initialize DARTS using: 
$S DARTS [-D path] [-E] oo ae arg9] 

where: _ 

-D path 


Specifies the absolute pathname of the selected 
initialization data base file. 
The default is >>SID>BULLSEYE. 


Causes each command input to be echoed at the operator's 
console. Use of -E is optional. 


—-~A argl... arg9 


Specifies between 1 and 9 optional arguments passed to 
the command processor executing DARTS commands in the 
data base file. (For details refer to "Execute Command 
File (EXC)" in Section 4.) 


Initialization Process 


Four major steps occur automatically in the initialization 
process: 


1. The establishment of the data collector. 


2. The creation of the Data Buffer Manager/Logger task. It 
is activated when the BFR and LOG commands are processed. 


3. A first pass at the commands in the data base file to 
generate the TICS structures for the predefined TIPs. 
Some or all of the TIPs can be activated. 


4. A second pass at the contents of the data base file to 
record each command onto the online log file (assuming 
that the log file has already been established by a LOG 
command). 


The DARTS collector is fully operational after completing 
these steps. 


| An nonrecoverable error in the execution of a command in this 
data base file automatically aborts the DARTS startup, deleting 
all constructed structures. Once the error has been corrected, 
DARTS can be reinitialized with another OCL command without 
adverse effect on the operation of other elements in the MOD 400 
system. : | 
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Data Base File 


The data base file is a sequential file set up by the user 
prior to the initialization of DARTS. It contains user commands 
that are processed sequentially during initialization to generate 
the execution environment for DARTS. User commands can configure 
the set of internal buffers, establish the log file, and specify 
TICS structures for all TIPs, or a relevant subset of TIPs. 
(Refer to Appendix B for recommendations and an example.) 


Use the MOD 400 Line Editor (ED), or Screen Editor (Scorpeo), 
to create and modify the data base file. (Refer to the GCOS 6 
MOD 400 Application Developer's Guide (Order No. C215) for a 
detailed description of the Editors.) Each command in this file 
must be specified as a single record of up to 256 bytes. No 
DARTS command specifically restricted to use from the operator's 
console can be present in the data base file. (For an example 
refer to "Execute Command File (XEC) in Section 4.) 


TERMINATION 
Terminate the DARTS facility using the OCL command: 
SS DARTS -Q 
The command gracefully shuts down all on-going collection and 
logging activities, closes the log-file, and deletes all internal 


structures and buffers. DARTS can be brought online again with 
another OCL initialization command. 
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Section 4 
COMMAND LANGUAGE 


USER INTERFACES 


The user has two interfaces to DARTS, for two entirely 
different purposes: 7 


1. USER TIP INTERFACE: A Trace Point interface to the data 
collector for use at each Trace Information Point (TIP). 


2. USER COMMAND INTERFACE: A command (OCL) interface to the 
command manager that defines the Trace Information | 
Capture Specification (TICS) for a TIP and controls the 
operation of the DARTS trace facility. 
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USER TIP INTERFACE 


The user can choose between two distinct types of TIP. 
interface when setting up a TIP: 


1% A General TIP interface available to all users 


2. A Special TIP interface available only to users executing 
at ring 0 on the DPS 6 system. ‘Typically, these are 
system tasks executing in the system pool ($S). 


There are two macros available in the MOD 400 system EXEC LIB 
macro library for defining TIPs within a user's application: 


l. Stipsp 


Specifies an environment in which a S$tip macro generates 
the instruction sequence of a special interface TIP. The 
Stipsp macro itself generates no instructions. 


2. Stip 


Generates a Trace Point instruction sequence of either a 
Special or a general interface TIP, depending on whether 
or not the Stipsp macro precede it. 


General TIP Interface 


This interface is built around the use of a trace instruction 
to request the services of the DARTS data collector. The 
one-word trace instruction (Z'1234') causes an illegal 
instruction trap that is intercepted by a special trap handler 
and in turn processed by the data collector. 


Provided that the Stipsp macro or an equivalent macro has not 
preceded Stip, the general (trap) interface can be arrived at by 
using the macro: 

Stip id 
where: 

id 

Represents the 16-bit TIP id specified as a 

four-character hexadecimal string. Refer to "TIP 


Identification Code" in this section. 


The macro generates the one-word trace instruction, followed 
by a one-word (16-bit) TIP id field. For example: 


DC 24'1234' 
DC Z'hhhh' | 


Note that hhhh signifies a four-character hexadecimal string. 
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Special TIP Interface 


| This interface is primarily reserved for system tasks. The 
user of this interface is responsible for supplying the collector 
with a stack of at least 128 bytes (pointed to by $B7) using 
register $B5 as the linkage register. The System Control Block 
(SCB) links the stack to the data collector. Offset S DART of 
the SCB contains the entry point address of the preamble to the 
DARTS data collector, 


When the Stipsp macro or an equivalent macro precedes Stip, 
the special interface can be arrived at by using: 


Stip id[,offset] 

where: 

id 
Is the 16-bit TIP id, specified as a four-character 
hexadecimal string. The TIP id field is generated 
following the link-and-jump instruction. 


offset 


An optional specification used only when register SB6 
points to a structure initialized with the address of the 
data collector at the specified offset. The generated 
instruction sequence is: 


LNJ S$B5,*SB6.o0offset 
DC Z'hhhh' 


Note that hhhh signifies a four-character hexadecimal 
String. 


When offset is omitted, the generated instructions make 
exclusive use of register SB5 to link to the data 
collector through the SCB. The instruction sequence is: 


LDB $B5,<ZHCOMM+X'18' 
LNJ $B5,*$B5.S DART 
DC 2" hhhh' 


The offset S _DART, defined in the SCB penpiace macro 
(Z3SCB), appears in the OS LIB macro ici 
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Predefined TIPs 


Users of standard software modules are encouraged to use. 
predefined TIPs, using either the general or the special TIP. 
interface. Tracing the execution of the module can be made 
standard with a static arrangement of TIPs of known identity. 


The information collected at these predef ined TIPs can be 
specified by DARTS commands. This permits flexibility in the 
selection of the information captured at each TIP. 


TIP Identification Code 

A DARTS TIP, whether it uses the general or the special 
interface, must have a 4-digit hexadecimal (16-bit) 
identification code unique in the domain of the DARTS facility; 
i1.e., the MOD 400 system. 


The TIP id digits are interpreted as: 


mmss 
where: 
mm 
Represents the two-digit module code, 
ss 


Represents the two-digit site code. 


Specific module codes are assigned to standard software 
modules incorporating predefined TIPs, with multiple TIPs ina 
module being identified by unique site codes, 


Module Codes Reserved for User Applications 
A module code of 00 is reserved for use by DARTS. Module 


codes EO through FF are reserved for the use of customer 
application software modules, 
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USER COMMAND INTERFACE 


The user command interface defines the format of the commands 
directed at DARTS from either the operator's console or a command 
file (such as the data base file). The command format is as 
follows: | 


SS DARTS xxx argument list 
where: 
XXX 


Represents the three-character mnemonic of a DARTS 
command. 


argument list 


Specifies an argument list consisting of one or more. 
positional and keyword arguments. Keyword arguments use 
a Single-character mnemonic prefixed with a hyphen. 
DARTS commands in the data base file use the same format 
as commands from the operator's console. Certain 
commands can only be issued from the operator's console. 


The maximum length of a command is 256 bytes. When issued 


from the operator's console, a command spans input lines by using 
a continuation character (&). 


HELP Messages 
A HELP message appears when a command is entered without an 
argument, Commands requiring no argument are exceptions to this 
rule: DBF, SLG, RLG, SFM, RFM and TFM. 
Command Execution 
There are three sources of commands to the DARTS facility: 
1. The initialization data base 


2. A command issued from the operator's console 


3. A command contained in a file being processed by the XEC 
command. 


The entire DARTS command set is available to the user from 
the operator's console. Some commands cannot be issued from the 
data base (during initialization), or from a command file 
processed as a result of the XEC command. These interactive-only 
commands appear in the list that follows. | | | 
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With the exception of a formatter request, every command 
executes synchronously. Fach command processor is part of an 


overlay of the DARTS bound unit. Fach loaded overlay, executes 


and unloads. in turn, 


User Commands 

A list of user commands él tows: Some commands can only be 
used in the interactive mode, as noted, 
TICS DEFINITION COMMANDS 

The Goliowina is a list of TICS def inition commands : 

ABT Abort TICS Definition Aborts the definition 


in progress of a TICS 
(interactive only) 


DAT Data Array Definition Defines data array to be 
collected 
DEF Define TICS Begins the definition of a TICS 
for a TIP 


DTC Display TICS Attributes Displays the attributes of a 
TICS for a TIP 
(interactive only) 

END End TICS Definition | Ends the definition of a TICS 


REG Register Set Definition Register set to be collected is 
| def ined 


REM Remove TICS Definition Removes the definition of a 
| TICS for a TIP 


TOE TICS Table of Entries Defines Table Of Entries €or 
TICS 
TICS MANIPULATION COMMANDS 
The following is a list of TICS manipulation commands: 
ACT Activate TICS ia Activates a defined TICS 


DEA Deactivate TICS Deactivates a defined TICS 
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a, 
NS 


RCX Reset Condition for Resets the Condition for 
Execution Execution of a TIP 


SCX Set Condition for Sets the Condition for Execution 
Execution of a TIP 


BUFFER POOL COMMANDS 
The following is a list of buffer pool commands: 
BFR Buffer Pool Definition Defines buffer pool attributes 


DBF Display Buffer Pool Displays buffer pool status 
(interactive only) 


LOGGER CONTROL COMMANDS 
The following is a list of logger control commands: 


LOG Log File Definition Defines log file to be used 


RLG Resume Logging Resumes logging operation 
(interactive only) 
SLG Suspend Logging Suspends logging operation 
(interactive only) 


FORMATTER COMMANDS 


The following is a list of formatter commands: 


FMT Format Logged Data Schedules formatting of logged 
data (interactive only) 

RFM Resume Formatting Resumes ongoing formatting 

(interactive only) 

SFM Suspend Formatting Suspends ongoing formatting 

| (interactive only) 
TFM Terminate Formatting Terminates ongoing formatting 
(interactive only). 
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GENERAL COMMANDS 


The following is a list of general commands: _ 


* Comment line, for use in Command files | 
XEC Execute Command File Executes commands in a Command 
file (interactive 
only) 


The remainder of this section provides a detailed description 
of each command listed alphabetically by title. 
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ABT 


ABORT TICS DEFINITION (ABT) 

Aborts the definition in progress of a TICS. 

FORMAT: | 
ABT id 

ARGUMENTS: | 

id 
A four-digit hexadecimal string TIP identifier defining 
the TICS being aborted. The left pair of digits 
represents a module code and the right pair represents a 
Site code within the module. 00 cannot be used as a 
module code. 


NOTE 


Use ABT only on a TICS definition in progress. 
For a defined TICS refer to the REM command. 


DESCRIPTION: 
This command can only be issued in the interactive mode. 
Example: | 

ABT EOO1 


Aborts the definition in progress of the TICS for 
TIP id EOO]. 
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ACT 


ACTIVATE TICS (ACT) 


Activates the specified list of defined but inactive TICS. 

FORMAT : 
ACT list 

ARGUMENT : 

list 
A list of one to eight TIP id elements, separated by 
Spaces. Each TIP id element can be either a Single id, 
including wildcards, or an id range specified as 
low/high. A TIP id is a four-digit hexadecimal string 
(mmss) specifying a TICS. (Refer to "TIP Identification 
Code" in this section.) 
A wildcard id of an asterisk (*) can activate all 
currently defined TICS. TICS of a specific module code 
can be activated using mm* as the id, where mm is the 
two-digit hexadecimal module code, or using mms* as the 
id, which implies activation of ids in the range mms0O and 
mmsF, 
Do not use a module code (mm) of 00. 

DESCRIPTION: 

The specified TICS is activated. 

Example 1; 
ACT #* 

Activates all currently defined TICS. 

Example 2: 
ACT EE* EFOQ5 


Activates all currently defined TICS for TIPs with module 
code EE and activates the TICS for the TIP EFOS. 


Example 3: _ 
ACT EE0O7/EE15 
Activates all currently def ined 7 with TIP ids of EEO7 


through ioe inclusive, — | | | | | 
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BER 


BUFFER POOL DEFINITION (BFR) 
Defines the attributes of the buffer pool used by DARTS. 
FORMAT: | 
BFR size number low limit 
ARGUMENTS: 
size 


The specified buffer size. It is rounded up to the next 
multiple of 256 bytes with a maximum size of 4096 bytes. 


number 
The initial number of buffers allocated. 
low. limit | 


The threshold at which the buffer manager acquires 
additional buffers to satisfy peak activity demand. The 
low limit must be less than the number of initially 
allocated buffers. The total number of allocated buffers 
cannot exceed 2 * number, 


DESCRIPTION: 


This command must be issued before the LOG command since some 
characteristics of the log file are determined by the buffer 
size in use. 


Example: 
BFR 10007 4 


Specifies internal buffers of 1024 bytes (next multiple of 
256) with an initial count of seven buffers and a low 
threshold of four buffers. (The total number of acquired 
buffers. cannot exceed 2 * 7 = 14 at any time.). 


NOTE 


Adjust the size and number of allocated buffers 
according to the rate of trace information being © 
collected. Although the collected data can span — 

several buffer blocks, buffers should be sized 

such that one block is large enough to accommodate 
the data from the TIP generating the most output. 
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DAT 
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Defines one data array entry (of up to four) in the TICS 
being defined. 


FORMAT: 


DAT address range [-L label] [-M limit] [-O] 
ARGUMENTS: — 
address 


The data array's address is computed from the prevailing 
register context (S$Bx and SRy) at the TIP. The specified 
address field can only be in one of the four 
Assembly-language-type formats listed below: 


Base Register addressing (x=l-7) 


SBx. OFFSET 
*SBx. OFFSET | 
SBx.SRy  (y=1-7) 
*SBx. SRy (y=1-7) 


The asterisk (*) represents indirect addressing. Indexed 
addressing allows for the use of all seven SR registers. 


OFFSET is a 16-bit signed value that must be specified as 
a decimal literal. It cannot be an expression. 


range 


Can be expressed as a decimal literal ranging from 1 to 
2000 bytes. A value in excess of 255 bytes is rounded up 
to the next multiple of 8 bytes. 


Alternatively, range can be specified as a $Rx register 
(x=1-7) for dynamic ranging based on the contents of the 
register. Range can also be specified as the contents of 
a location addressed by the syllable SBx.OFFSET. (Note 
that indirect addressing is not allowed in range 

, addressing. ) 


A limit of 2000 bytes of data collected is imposed with 


dynamic ranging. A lower limit can be specified (see 
example 1). | | | 
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DAT 


-L label 


This argument is optional and can be used to specify a 
one- to eight-character string to be used by the , 
formatter when outputting individual data arrays. It is 
recommended that it be specified. If omitted, eight 
blanks are used as the label. 


-M limit 


This argument is optional. It can be expressed as a 
decimal literal. The argument enforces a limit on data 
collected with dynamic ranging. If greater than 255 
bytes, the limit is rounded down to a multiple of 8 


bytes. 
-O 
This optional argument indicates that data collection 
begins with the right byte of the first location in the 
array being addressed (odd-byte addressing). 
DESCRIPTION: 


A maximum of four data arrays can be specif ied for each 
TICS. A maximum of 8000 bytes of data can be collected. 


Example 1: 


DAT *$B4.4 $R2 -L BUFFER -M 200 


Specifies a data array, labeled BUFFER, that can be 


indirectly addressed by a pointer at offset 4 of a structure 
pointed to by SB4. The length of the array (in bytes) is 
specified by the contents of SR2 at the TIP. It is limited 
to 200 bytes in this example. 
Example 2: 

DAT SBl 40 —-L CODE 


Specifies a data array of 40 bytes, labeled CODE, pointed to 
by SBl when the TIP is executed, 
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‘DEA 


DEACTIVATE TICS (DEA) 


Alters the state of the specified list of TICS from active to 
inactive. > 2 | | - | 


FORMAT: 
DEA dlist 
ARGUMENT : 
list 
A list of one to eight TIP id elements separated by 
spaces, Each TIP id element can be either a Single id, 
including wildcards, or an id range specified as | 
low/high. 
DESCRIPTION: 
The specified list of active TICS is deactivated. This 
command is complementary to the ACT command. Refer to the 
ACT Command description for more details and examples. 
Example: | 


DEA E109 


Deactivates TICS E109. 
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DEF 
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Starts the definition of a TICS. 
FORMAT : 
DEF id 
ARGUMENT: 
id 
A four-digit hexadecimal string that specifies a TIP id. 
The left pair of digits represents a module code and the 
right pair represents a site code in the module. 00 
cannot be specified as a Module Code. (Refer to "TIP 
Identification Code" in this section.) 
DESCRIPTION: 
A TICS specification consists of the following commands: 
DEF to start the specification of a TICS. 
REG to define the register context (optional, single). 
DAT to define any data array entries (optional, multiple). 
END to close out the specification. 
The DEF command begins and the END command finishes the 
definition of a TICS. The initial state of the newly defined 
TICS structure for a TIP is inactive. 
The TICS can be activated by the ACT command and deactivated 
by the DEA command. While the definition is in progress, it . 
can be aborted with the ABT command. Once defined, it can 
only be removed with the REM command. 
Example: 
DEF EEOQF 


Starts the definition of the TICS for TIP id EEOF. 
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DBF 


DISPLAY BUFFER POOL STATUS (DBF) | 
Displays the current status of the DARTS buffer pool. 
FORMAT: 
DBF 
ARGUMENT: 
None, 
DESCRIPTION: 
This command can only be issued in the interactive mode. 
The status of the Buffer Pool is displayed at the operator's 
console in the form of relevant counts, such as: buffers in 


use, buffers available, minimum number of available buffers, 
etc. 
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DTC | 


DISPLAY TICS ATTRIBUTES (DTC) 

Displays the current status of a defined TICS. 

FORMAT: 
DTC id 

ARGUMENTS: » 

id 
A four-digit hexadecimal string that specifies a TIP id. 
The left pair of digits represents a module code and the 
right pair represents a site code in the module. 00 
cannot be specified as a module code. (Refer to "TIP 
Identification Code" in this section.) 

DESCRIPTION: 

This command can only be issued in the interactive mode. 

All the attributes of the TICS of the specified TIP id are 

displayed at the operator's console, The information 

includes the details of the REG and DAT commands, used to 


define the TICS, as well as the condition(s) for its 
execution, via the SCX command, if any. 
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END 


END TICS DEFINITION (END) - 

Specifies the end of the definition of a TICS. 

FORMAT : 
END id 

ARGUMENT: 

id 
A four-digit hexadecimal string that defines the TIP in 
question. The left pair of digits represents a module 
code and the right pair represents a site code in the 
module. 00 cannot be specified as a module code, (Refer 
to "TIP Identification Code" in this section.) 


DESCRIPTION: 


The id field is checked for validity against the id of the 
TIP for which a TICS definition is in progress. | 


Example: 
END EEOF 


Specifies the end of the definition of the TICS for TIP EEOF. 
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XEC 


EXECUTE COMMAND FILE (XEC) 
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Schedules the execution of a DARTS Command File. 
FORMAT : 
XEC path [-E] [-A argl... arg9] 
ARGUMENTS : 
path 


Specifies the absolute pathname of the DARTS Command file 
to be executed, 


This optional argument causes the echo of each command as 
read from the file to the operator's console. 


-A argl...arg9 


An optional argument specifying between one and nine 
substitution values, separated by spaces, used when 
processing individual commands contained in the DARTS 
Command file (path). These commands use the expression 
?Pn (n= 1 to 9) in places where substitution is desired. 
The default argument is a null string. 


NOTE 

-A must be the last argument of the command string. 
DESCRIPTION : 
The execution of this command results in the sequential 
processing of every command in the specified file. Within 
the file each DARTS command mnemonic must begin in the first 
column of a line. An asterisk as the first character 
indicates a comment line. 


NOTE 


This command can only be issued in the interactive 
mode from the operator's console, | 
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XEC™ 


Example 1: 
XEC >UDD>TICS EE -E 


Executes every command in the DARTS Command file named — 
>UDD>TICS EE, with echo of each command on the operator's 
console. | | 


Example 2: 

XEC >UDD>TICS EO -A SB4 S$R4 
Executes every command in the DARTS Command file named 
>UDD>TICS EO, substituting $B4 and $R4 for the parameters ?Pl 
and ?P2, respectively, contained in the file >UDD>TICS EO. 


For example, if the commands in the file were: 


DEF EOOL 

REG ?P2 $SR5 

DAT $B1.?P2 ?P1 -L ARRAY 
END EQO] 


the effective commands would be: 
DEF EQOL] 
REG $R4 SB5 


DAT $B1.SR4 $B4 -L ARRAY 
END EOOL 
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FMT 


FORMAT LOGGED DATA (FMT) 


Refer to Section 5 for a detailed description of this and 
other Formatter Control commands, | 
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LOG 


LOG FILE DEFINITION (LOG) 


Establishes a new log file after closing out the current log. 
file. 


FORMAT: 
LOG oe [-S size] 

ARGUMENTS : 

path 
Specifies the absolute pathname of the log file to be 
established. The file is re-created each time it is 
specified in this command. 

-S size 
An optional argument specifying a log file of a number of 
blocks equal to the size parameter specified (in 
decimal). This file will be used in a wraparound mode by 
the DARTS buffer logger. 
The actual size of each block in this file is governed by 
the size of the internal buffers defined by the BFR 
command. 

DESCRIPTION: 

This command must be preceded by the BFR command and must be 

issued before any ACT command. Omission of the -S argument 

results in the generation of an open-ended log file. 

Example 1: 

- LOG >SID>FIRST LOG 

Establishes an open-ended log file named >SID>FIRST LOG 

Example 2: 
LOG >>UDD>LOG FILE -S 500 


Establishes a wraparound log file neues >>UDD>LOG _FILE able 
to accommodate 500 buffer blocks. 


4-22 0874-01 


Sd 


REG 


REGISTER SET DEFINITION (REG) 


Defines the register set whose contents is to be collected at 
the TIP in question. 


FORMAT: 

REG list 
ARGUMENT: 
list 


The list of registers must be separated by spaces and can 
be one or more of the following elements: 


* All registers 
SR* All SR registers 
SRx Register SRx (x=1-7) 
SB* All SB registers 
SBx Register SBx (x=1-7) 
SI Indicator register 
SM1 Mode register Ml 
DESCRIPTION: 


No register's content is collected when the REG command is 
omitted during the definition of a TICS. The REG command can 
appear only once in the definition and no register can be 
specified more than once in the command. 


Compare its use in the definition of a TICS with those of the - 
DEF, DAT, and END commands, | 


Example 1: 
REG S$R1 $B4 


Specifies collection of the contents of SR1 and S$B4. 


4-230 74-001 


a ty toes eee Re On ee se 8 Re BRS oR A 9 EE tS a a ae ae ba a 36 : * Pe, = s% be ee ee as 2 ty SPE Ae ee ee ke Bon eet Se Sy see Se, Tee ee le a te ee pee cee Ta ie SRR a, oe CHES ST eg Ge ne Sa Re fees RET a ie a 
Ba wate AR ST eee wk Sd yp ts Be Coe - fete cela ete oe + opie Be eras ah ata an Sas tee ee CS SEE len Med tee OS RTE ee Oy igh we OR den Beer a A ot Be Nee oy CR pT ig tee ST eg 7 feat oe 7 Se : 
Ale ost coat eee ay . 4 we Bea ama a REET ET cee ee seme PRE BE ae Re mE ted ea ETS eae ES SO Ss Eas 2 ee TO SELES CLI a ets Ba Pa ee Te LE ae Re Re RE Fred SOUR TP ae cate cle EL Tatheaioe 


REG 


Example 2: 
REG $B* SI 


Specifies collection of the contents of $I and all base 
registers. 3 


Example 3: 
REG #* 


Specifies the collection of all R-registers, base registers, 
$I and S$Ml. 
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REM — 


REMOVE TICS DEFINITION (REM 


Removes the definition of the specif ied list of TICS from the 
table of defined TICS. 


FORMAT: 
REM list 
ARGUMENT: 
list 
A list of one to eight TIP id elements separated by 
Spaces. Each TIP id element can be either a single id, 
including wildcards, or an id range specified as 
low/high. 
DESCRIPTION: 
Deletes the specified list of (active or inactive) TICS from 
the table of currently defined TICS. This command 
complements the DEF/END sequence of TICS definition 
commands. However, while TICS can only be defined 
individually, they can be removed as a list. 
Refer to the ACT command description for more examples. 


NOTE 


Use REM only on defined TICS. For a TICS 
definition in progress refer to the ABT command. 


EXAMPLE : 
REM EE* 


Removes the definitions of all TICS associated with TIP ids 
of module code EE, 
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RCX 


RESET CONDITION FOR EXECUTION (RCX) 


Resets the condition set (by the SCX command) for the 
execution of a specified TIP. 


FORMAT : 
RCX id 

ARGUMENT: 

id 
A four-digit hexadecimal string that specifies a TIP id. 
The left pair of digits represents a module code and the 
right pair represents a site code in the module. 00 
cannot be specified as a module code. (Refer to "TIP 


Identification Code" in this section.) 


DESCRIPTION: 


Resets an imposed condition for execution of a TIP, ensuring 
that the specified data is collected each time the Trace 
Point executes. 
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RFM 


RESUME FORMATTING (RFM) 


Refer to Section 5 for a detailed description of this and 
other Formatter Control commands. 
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RLG 


RESUME LOGGING (RLG) 
Resumes logging after a suspension. 
FORMAT : | | 
RLG 
ARGUMENTS: 
None 
DESCRIPTION: 
The RLG command can only be issued in the interactive mode. 
It displays a message at the console acknowledging execution 
of the command. 
Example: 
RLG 


Resumes logging after logging has been suspended, and returns 
a message to the operator's console, 


Message: 


Logging Resumes 
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SET CONDITION FOR EXECUTION (SCX) 


Sets the condition for execution of a specified TIP. Specify 
either a basic condition (Format 1) or a compound condition 
(Format 2). | 


FORMAT 1: 


SCX id cond-1l 


FORMAT 2: 


SCX id cond-1 oper-1 cond-2 [oper-2 cond-3] 


ARGUMENTS : 


id 


A four-digit hexadecimal string specifying a TIP id. The 
left pair of digits represents a module code and the 
right pair represents a site code in the module. 00 
cannot be specified as a module code. (Refer to "TIP 
Identification Code" in this section.) 


cond-l (cond-2 cond-3) 


A conditional entity (without embedded blank separators) 
that has a logical value (.TRUE. or .FALSE.). 


Specify the condition in one of two ways: 
[“]<exp-1> [&<mask-1>] 
Or 
[*] <exp-1> [&<mask-1>]<relation><exp-2> [&<mask-—-2> ] 
where: | 
<exp> can be a: 
Decimal literal 
Hexadecimal literal 


 §$R register 
Address syllable 


<mask> is an optional hexadecimal literal 
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SCX | 


<relation> is one of six operators: 


less than 

equal to 

greater than 

not less than 
not equal to 

not greater than 


> OV AN 


VILA 


> 


NOTE 


See extended notes regarding the use of condition 
parameters in Notes for Condition Parameters 
below. 


oper 


A single character representing either a logical .AND. 
or a logical .OR. operator. Use it to combine up to 
three condition entities into a compound condition. 


-AND. is represented by the ampersand ('&', X'26'), and 
~OR. is represented by the vertical bar ('|', X'7C'). 
The .AND. operator takes precedence over the .OR. 
operator. 


DESCRIPTION: 


Once a TICS is defined and activated, execution of a TIP 
results in complete data collection according to the TICS 
specification. The default is unconditional execution, 
everything will be gathered. | 


Imposing a condition on TIP execution ensures that data 
collection occurs only when the specified condition evaluates 
to a logical .TRUE. Conditional execution results either in 
no data being collected, or nothing but specified data being 
collected. 
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SCX 


Example 1 (using Format ae 
SCX E204 $B2.6&X400 


Specifies that data should be collected upon execution of TIP 
id E204 (only if bit 5) of the location at offset 6 of a 
structure pointed to by base register $B2, is set. Bit 5 is 
equivalent to a mask of X'0400'. 


Example 2 (uSing Format 2): 
SCX EFO1 $R1°=0 & $B3.2&XFF00=X1500 


Specifies that data should be collected upon execution of TIP 
id EFO1 only if the content of SRl1 is non-zero, and offset 2 
of a structure pointed to by base register $B3 contains a 
value of 21 decimal (15 hexadecimal) in the left byte. 


Notes for Condition Parameters 


1. The optional leading NOT operator (%) is used 
to reverse the logical value of the evaluated 
condition. 


2. A decimal literal is a Signed value in the 
range of -32,768 to +32,767. 


3. A hexidecimal literal is specified as a string 
of 1 to 4 hex-digits (leading zeros are 
assumed) prefixed by the character X. Do not 
use quotation marks. 


4. A SR register should be specified as S$Rn (n=1 


to 7). Its contents will be used for the 
value of the <exp>. 
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‘SCX 


5. The address syllable addresses a location 
whose contents is used as the value of the 
<exp>. | | - | 


The address syllable can be specified in one 
of four formats: | | 


SBx. Offset (x=l1 to 7) 
*SBx.Offset - 
SBx. SRy (y=l1 to 7) 
*SBx.SRy 


The asterisk (*) represents indirect 
addressing. Offset 1s a Signed decimal 
literal in the range of -32,768 and +32,767. 


6. The mask cannot be specified if <exp> is a 
decimal or a hexadecimal literal. 


In the first format, <exp-1>&<mask-l> amounts 
to a Load-Bit instruction. The absence or 
presence of the leading NOT (*) operator turns 
the condition into a test for bit true or bit 
false. 


In the second format, the <mask> can be used 
to eliminate the "don't care" bit(s) in the 
value of an <exp> in order to specify 
conditions keyed by individual bytes. 
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SUSPEND LOGGING (SLG) 
| Suspends the logging facility. 
FORMAT: 
SLG 
ARGUMENTS :_ 
None 
DESCRIPTION: 


Logging can only be suspended; it cannot be terminated except 
when terminating DARTS with the OCL command: 


SS DARTS -Q 


Note that data collection ceases as soon as logging is 
suspended so as to avoid a buffer overrun condition. 


This command can be issued only in the interactive mode. It 
displays a message at the console acknowledging execution of 
the command. | | 
Example: 

SLG 


Suspends the logging facility, and displays a message at the 
operator's console, 


Message: 


Logging Suspended 
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oof 


SUSPEND FORMATTING (SFM) 


Refer to Section 5 for a detailed description of this and 
other Formatter control commands. | 
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TABLE OF ENTRIES FOR TICS (TOE) 


Defines the size of the TICS table of entries. 
FORMAT: | | 

TOE n 
ARGUMENT: 
n 

Specifies the number of expected TICS entries. 
DESCRIPTION: 


This command must be issued before the first DEF command can 
begin a TICS definition. 


The size of an existing table can be increased by issuing a 
TOE command with a larger value of n. 


Example: 
TOE 30 


Specifies that up to 30 TICS definitions can follow. 
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TERMINATE FORMATTING (TFM) 


Refer to Section 5 for a detailed description of this and 
other Formatter commands. 
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Section 5 
LOG FILE 
FORMATTER 


The log file formatter, scheduled by an interactive FMT 
command, iS a spawned task operating at the same level as the 
DARTS command manager. Subsequent user commands can be used to 
control the formatter request. 

Invoking DARTS from any user task group results in its 
exclusive use as a formatter. In this mode the DARTS formatter 
cannot be controlled; it either executes to completion or aborts 
when an error occurs. The command requires arguments that 
constitute a formatter command resulting in the execution of a 
Single formatter request. 

The format of the ECL command is: 

DARTS FMT path name argument list 
wheres | 

path name 


Specifies the absolute pathname of the log file being 
formatted. | 


argument list 


Refer to FMT command in this section. 
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LOG FORMATTER OUTPUT 


- Pormatted output has a standard format. For each TIP there 
1s: | a _ | 


e A time-stamped header line 

e A TIP id in hexadecimal notation 

e The sequence number of the TIP's execution 

e The SR and $B register contents, when selected. 


Refer to Appendix E for a complete example and description of 
fotmatted output, 


FORMATTER COMMANDS 
The remainder of this section provides a detailed description 


of the Formatter commands. They are presented in alphabetical 
order. 
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FMT 


FORMAT LOGGED DATA (FMT) 
Generates formatted oueeee from the raw data in the specified 


log file. 
FORMAT: 
path . 
FMT 3 [-O output file] [-F date time] [-T date time] 
[ -I list] 
ARGUMENTS : 
path 
T£ the current 


Specifies the log file to be formatted. 
log file is to be formatted, use the keyword -L instead 
to select online current formatting. 


-Q output file 
Directs formatted output to an output file that is 
re-created each time. 


Default: !LPTOO 


-F date time 
Date time 


Specifies the leading edge of the time window. 
must be specified in the form yyyy/mm/dd: hhmm or hhmn, 


with the current date being used in the latter case. 


Default: The time at the beginning of the log file. 


-T date time 
| l The 


Specifies the trailing edge of the time window. 
Format of date time is as described above. 


Default: The time at the end of the log file. 
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FMT 


-I list 


Specifies a list of one to eight TIP id elements, 
separated by spaces. If omitted, all TIPs in the time 
window are formatted. Each TIP id element can be either 
a Single id, including wildcards, or an id range | 
specified as low/high. Refer to the description of the 
ACT command (refer to Section 4) for details on TIP id 
element specification. 


DESCRIPTION: 


The selection of information to be formatted is undertaken in 
the following manner: 


1. A time window is specified by the -F and -T arguments. 
This determines the absolute perimeter of the formatting 
operation. 


2. In awindow, either all the TIPs or a select list of TIPs 
can be formatted. 


This command can be issued only in the interactive mode. 
Example: 


FMT >SID>FIRST LOG -O !LPTOO -I EF* ECO1/ECO7 
-F 1986/2/1:1431 -T 1986/2/1:1435 


Generates formatted output from the data in the log file 
>SID>FIRST LOG. Directs output to the line printer LPTOO. 
The time window for formatting is 2:3lpm to 2:35pm on 

February 1, 1986. Displays only the data captured on behalf 
of the module code EF and all TIPs in the range ECOl and 
EC07. 
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RESUME FORMATTING (RFM) 


Resumés the execution of the suspended formatter. 
FORMAT : 
RFM 
ARGUMENTS : 
Nona... 
DESCRIPTION: 
This command can only be issued in the interactive mode. It 
displays a message at the console acknowledging execution of 
the command, 
Example: 
RFM 


Resumes execution of a formatting request and displays a 
message at the operator's console. 


Message: 


Formatting Resumes 
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SFM 


SUSPEND FORMATTING (SFM) 
Suspends the execution of ee ee 
FORMAT: 
SFM 
ARGUMENTS : 
None, 
DESCRIPTION: 
This command can only be issued in che: tneepactive mode. It 
displays a message at the console acknowledging execution of 
the command. 
Example: 
SFM 


Suspends execution of a formatting request, and displays a 
message at the operator's console. 


Message: 


Formatting Suspended 
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TERMINATE FORMATTER (TFM) 
Terminates the execution of a formatter request. 
FORMAT : 
TEM 
ARGUMENTS ; » 
None. 
DESCRIPTION: 
The TFM command is the sole means of termination when uSing 
the formatter to process the online log file (even as the 
data is being logged) with no specified time window. 
The TFM command can be issued only in the interactive mode. 
It displays a message at the console acknowledging execution 
of the command. 
Example: 
TEM 


The formatter is terminated with indication at the console, 
and displays a message at the operator's console, 


Message: 


Formatting Request Terminating 
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Appendix A 
ERROR MESSAGES 


The MOD 400 message library maintains error messages (and 
some informational messages) issued by DARTS. The DARTS 
component code is 6F; therefore, all messages use the code 6Fxx. 
INTERPRETING MESSAGES 


All messages use the character string substitution facility 
to identify the subcomponent of DARTS that is issuing the message 
and other pertinent information. For example, the error message 
issued when processing the command DEF 0X23 is as follows: 


6F36 DEF: Invalid TIP id: 0X23. It should be precisely 
4 hex digits. 


where: 
6F36 


6F is the DARTS component code, and 36 is the message 
identification number, 


DEF 
The DARTS subcomponent name. 
0X23 | | 


The invalid TIP id in this example. It contains a 
nonhexadecimal digit. 
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As a way of representing actual entries, these messages 
adhere to the following convention: . 


6F03 


6F04 


6F05 


6F 06 


6F07 


6F08 


6F09 


6FOA 


6FOB 


6FO0C 


6FOD 


6FOE 
6F OF 
6F10 
6F1l1 


A lowercase letter enclosed in a less than (<) sign and 
greater than (>) sign Tes a returned tere For 


XXX 


AXX 


AXX 


ZXX 


XXX 2 


XXX 


RAKE 


KXX & 


XXX% 


XXX 8 


XXX s 


XXX S 


XXX $ 


XXX 


XXX s 


2 * « @ €@ 


xxx represents a command mnemonic. 


DARTS is not configured in the system. 
Include LDBU ZXDJ directive in CLM USER file 
and reboot, 


DARTS thonitor is already in use. Duplicate 
invocation rejected, 


DARTS is still executing previously issued 
command. This command is being ignored, 


DARTS monitor operations are being 
terminated, 


This command cannot be issued before invoking 
DARTS monitor, 


DARTS invocation arguments can only be: -D 
<path_ name> and -E, with -A as the last 
Keyword. 

Data base (pathname) error: <pppp>. 
Initialization overlay could not be loaded. 


Exit processor overlay could not be loaded. 


XEC command processor overlay could not be 
loaded. 


Command processor overlay could not be loaded 
for <xXX> command. 


Formatter overlay could not be loaded. 


DARTS command execution uae completed, 


Required memory block could DOF be obtained. 


DARTS initialiaation in progress, Please wait 
for the completion message. | _ 
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6F12 


6F13 


6F15 


6F16 


6F17 


6F18 
6F19 
6FLA 
6F1B 
6F1C 
6F1D 
6F1E 
6F21 
6F22 
6F23 


6F24 


6F25 


6F 26 


6F27 


6F28 


SXX Ss 


XXX 5 


XXX 


XXX § 


XXX 6s 


XXX S 


RKXX o 


XXXo 


AXX & 


XXX 


XXX S 


XXX s 


RAZ 


RAX Ss 


XXX & 


SAKE 


RAR s 


XXX s 


XXX 


SAX 


DARTS initialization completed. Monitor is 
ready for commands. 


DARTS initialization has failed. Please 
correct the error and retry. 


Log file switch is not possible in case of 
circular log files. 


Error in log file size specification via -S 
¢<n> option. <n> should range from 16 to 4096. 


Get file information error for the file: 
<PPPP>. 


Create file error for the file: <pppp>. 
Get file error for the file: <pppp>. 

Open file error for the file: <pppp>. 

Read record error for the file: <pppp>. 
Write record error for the file: <pppp>. 
Read block error for the file: <pppp>. 
Write block error for the file: <pppp>. 
Unbalanced quotes in command input: <iiiiii>. 
Invalid command mnemonic: <cccc>. 
Unknown/unsupported command: <cccc>, 
Required argument(s) missing. Issue this 
command without arguments to determine its 
format. 

ExcesSive arguments specified. Issue this 
command without arguments to determine its 


format. 


Unknown argument/keyword specified in command 
input: <kkkk>. 


Command permitted only in interactive mode: 
<CCCC>,. 


TOE command must be issued before this 
command, 
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6F29 


6F2A 


6F2B 


6F2C. 


6F 2D 


6F2E 


6F30 


6F31 


6F32 


6F33 
6F34 
6F35 
6F36 


6F37 


6F38 
6F39 


6F3A: 


6F3B 


XXX 


XXX3 


XXX S 


XXX S 


XXX S 


RXX 8 


AXX 


XXX $ 


XXX2 


XXX $ 


XXX 


RX S 


XXX 8 


LOG command must be issued before this 
command. 


BFR command must be pescad before this 


command, 
No log file assigned as yet. 


Log file switch rejected since concurrent 
formatting is in progress. 


No formatting request in progress, 
Formatting request is already in progress. 


Specified log file is not a DARTS created log 
file: <pppp>. 


TICS definition is already in progress. END 
the current definition before attempting a 
new one, 


TICS definition is not in progress, This 
command is being ignored, 


TICS definition is being duplicated for Id: 
<hhhh>. Remove the old definition before 
attempting redefintion.. 

Undefined TIP id: <hhhh>, 


The specified TIP id: <hhhh> does not match 
the id currently being defined: <hhhh>. 


Invalid TIP id: <hhhh>. It should be 
precisely four hexadecimal digits. 


Invalid TIP id: <hhhh>. The error is in the 


module/site code, 

Invalid TIP id delimiter. 

Data entry overflow (>4) in current TICS 
definition. This definition should be ended 
(END) or aborted (ABT). 


Invalid/unsupported address field in DAT 
entry: <aaaa>,. 


Invalid base register specification: <rrrr>. 
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6F3C 
6F3D 
6F3E 
6F3F 


6F 40 


6F 41 
6F42 


6F 43 


6F44 


6F45 
6F4A 


6F4B 


6F4C 


6F 4F 


6F50 
6F51 


6F52 
6F53 
6F54 
6F55 


XXX S 
oe 
XXX s 
XXX ¢ 


XXX 


XXX $s 


XXXs 


XXX 


AXX 8 


XXX 
KXX S 


KAX 


XAXs 


XXX 6s 


XXX S 
RXX 


XXX S 
AXX 
XA 


XXX S 


Invalid index register specification: ::<rrrr>. 
Invalid range register specication: <rrre>. 
Invalid offset specification: OOOO wee Ve 
Invalid range literal specification: <lill>. 


Range (literal) specification exceeds | 
prescribed limit (2000 bytes). 


Data entry Label specification is missing. ©: 
Invalid delimiter to base/index register. 


Range limit (-M) can be specified only for 
dynamic ranging. 


Range limit (-M) specification is in error. 


Range limit (-M) specification exceeds 
prescribed limit (2000 bytes). 


Duplicate REG command issued in this TICS. 
definition. 


Invalid register specification: <rrrr>. 


Duplication of register specification with 
the selection: <rrrr>. 


Buffer low condition corrected. Currently 
<nnnnn> TIPs have executed for which DARTS 
was unable to collect data due to buffer low 
condition. 


Three arguments are required with the BFR © 
command, 


BFR arguments have already been defined. ©... 
This command is being rejected. 


Buffer size argument error: <nnnnn>. 
Buffer initial count argument error: <nnnnn>. 
Buffer low threshold argument error: <nnnnn>. 


The BFR initial count argument has to.exceed 
the low threshold argument. 


3 <*% Poa Ay 
+ ban + oe 
aie Ne ae Bt 
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6F56 


6F57 


6F58 


6F59 
6F5A 
6F5B 
6F5C 
6F5D 


6F5E 


6ESP 
-6F60 
6F72 


6F73 
6F74 


6F75 


6F76 
6F81] 


XXX2 


XXX $ 


XXX 2 


RXX S 
ae 
XXX S 
XXX S 
XXX 8 


XXX S 


XXX 
XXX 


XXX s 


XXX s 


XXX 8 


AXX S 


XXX 


ae 2 : . 


_ TICS Table of Entries (TICTOE) overflow 
condition. 


Expand the table with a new TOE 
command before attempting new definitions. 


Invalid value for the size of the Table of. 


Entries (TOE): <nnnnn>. 


Specified size value cannot be less than or 
equal to the existing value. The TICTOE | 
table can only be expanded. 


Log File pathname must be specified in 
command input. 


Output File pathname has not been specified 
in command input. 


Specified value is in error for the keyword: 
<kkkk>. 


Formatter Time Window specification or 


mapping error. 


No more than eight TIP id elements are 
allowed with -I keyword. 


Invalid combination of formatter options 
results from the selection of the keyword: 
<kkkk>. 


Duplicate specif ication of the keywords: 
<kkkk>. 


Required argument is missing for the keyword: 
<Kkkk>. 


Slewing through command file until END 


directive encountered (or end of file). 


ea se @ e*# 8 @ 


Slewing stops with the command: 


Only -E and -A are allowed as keyword 
arguments. 


More than nine arguments follow the -A 
keyword. The -A should be the last BEL WORE | 
in the command. . 
No argument specif ied after “the -~A keyword. 


No condition has been specified in this 
command. 
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6F82 


6F83 


6F84 


6F85 


6F86 


6F87 


6F88 


6F89 


6F8A 


6F8B 


6F8C 


6F8D 


6F8E 


6F8F 


XXX s 


XXX 8 


XXX: 


XXX ¢ 


XXX 


AAXX 


AXX ¢ 


XXX ¢ 


XXX ¢ 


XXX 


XXX 


XXX 


XXX 5 


XXX 


Too many conditions have been specified in 


the command. Only up to three basic 
conditions, suitably compounded, can be 
specified. 


The compound condition specified is not 
properly structured. The compounding 
operators can only be & (AND) or | (OR). 


Invalid condition compounding specified in 
the command: <ccccc>. 


Incomplete condition expression specified: 
<eeeee>. The error is at about byte offset: 
<bbbb>., 


Invalid logical NOT operator specified: 
<eeeee>. The error is at about byte offset: 
<bbbb>. 


Invalid indirection operator (*) specified: 
<eeeee>. The error is at about byte offset: 
<bbbb>. | 


Indirection can be used only with SBx 
addressing: <eeeee>. The error is at about 
byte offset: <bbbb>. 


A valid register mnemonic does not follow § 
Sign: <eeeee>, The error is at about byte 
offset: <bbbb>, 


Invalid $Rx register specified: <eeeee>. The 


error is at about byte offset: <bbbb>. 


Invalid $Bx register specified: <eeeee>. The. 
error is at about byte offset: <bbbb>. 


Invalid extension specified after SBx: 
<eeeee>. The error is at about byte offset: 
<bbbb>. 


Invalid index register specified: <eeeee>. 
The error is at about byte offset: <bbbb>. 


Invalid hexadecimal string specified: 
<eeeee>. The error is at about byte offset: 
<bbbb>. 


Presumed decimal number is not specified: 


<eeeee>. The error is at about byte offset: 
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6F90 xxx: Invalid AND mask spécified: <eeeee>. The 
error is at about byte offset: <bbbb>. 
6F91 xxx: —«* Invalid relation operator specified: <eeeee>. 
| The error is at about byte offset: <bbbb>. 
6F92 xxx: Required expression following a relation 
| operator is missing: <eeeee>. The error is 
at about byte offset: <bbbb>. | 
6F 96 xxx: A condition is already defined for the TIP 


id: <hhhh>. Reset the condition with an RCX 
command and retry. 


A-8 | — CZ74-01 


Appendix B 
DATA BASE 
RECOMMENDATIONS 


Include the following three commands in the initialization 
data base file in the order presented: 


TOE 


BFR 


LOG 


n 


Defines the size of the TIP Table of Entries (TIPTOE). 

(n should be greater than the number of TICS likely to be 
specified in subsequent DEF commands. Refer to the TOE 
description in Section 4.) 


size number low limit 
To define the chain of internal buffers to be used by the 
DARTS Data Collector. Refer to the BFR description in 
Section 4. 

path name 
To define the initial log file to be used. Unless 
defined as part of the initialization process, the 
commands issued to DARTS from the data base are not 
logged. Refer to the LOG description in Section 4, 

Sample Contents of >>SID>BULLSEYE 
TOE 30 


BFR 100084 
LOG >UDD>DARTS LOG 
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Appendix C 
USING DARTS: 
AN EXAMPLE 


Figure C-l1 shows a software module called TEST. The module 
contains predefined Trace Points EEO], EE0O2, and EEO3. DARTS 
traced TEST's execution using the Trace Collection Specifications 
(TICS) set forth in Figure C-2. Figure C-3 illustrates formatted 
trace data. TEST was executed four times; each time using a 
different OCL command format. 


The TEST program shows the use of both the Stip and Stipsp 
macros, Stipsp generates an environment for special interface 
TIPs EEQ2 and EEO3. TEST executed in the system pool ($$), 
allowing it use of the special interface. If executed from any 
other pool, TIPs EE02 and EEO3 would have amounted to no-ops, due 
to lack of ring 0 privilege. 


The TEST program was located under both the HIS and SYSLIB1 
directories. The four OCL commands used in the test were: 


SS >HIS>TEST PARM-ONE 

SS >HIS>TEST | | 

SS >SYSLIB1>TEST PARM-ONE-IS—-MORE-THAN-10-BYTES 
SS >SYSLIB1L>TEST TERRY BENTLEY 
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10-7129 


000290 
000291 
000292 
000293 
000294 
000295 
000296 
000297 
000298 
000299 
000300 
000301 
000302 


000303. 


000304 
000305 
000306 
000307 
000308 
000309 
000310 
000311 
000312 
000313 
000314 
000315 
000316 
000317 
000318 
000319 
000320 
000321 
000322 
000323 
000324 
000325 
000326 
000327 
000328 
000329 
000330 
000331 
000332 
000333 
000334 
000335 
000336 
000337 
000338 
000339 
000340 
000341 


0000 
0001 
0002 
0003 
0004 


0005 
0006 


0007 
0008 
OO0A 


000C 


000D_ 


OO0E 


OOOF 
0012 
0014 


0015. 


0018 


001B_ 


001D 


OO1E. 


OO1F 


OO5F 


9877 
ACF7 
A872 
BCF7 
B873 


1234 
EEO] 


9CD7 
FBCO 
B970 
0903 


CCF1 
C874 


DC80 
D3CD 
EEO 2 


EC80 


 D3CE 
OOLA © 


EEO3 


AB70 
0001 
0103 


5454 


0000 


0056 
&3C0 


OOOF 


0000 0018x 
0102 
0000 0018x 


0102 
0000 


5454 
OO5F 


@ | STIP EEQ1 
DC Z*1234! DARTS INSTRUCTION 
DC Z*EEO1! TIP ID 
* : 
@ STIPSP STIP WILLNOW REVERT TO SPECIAL INTERFACE GENERATION 
kk*k 
keK ONLY SPECIAL INTERFACE TIPS BEING DEFINED HENCEFORTH 
kKE* 
LDB SBl ,=$B7 SBl <- PTR TO REST OF PARM BLOCK 
LAB $B7, STACK SB7 <- STACK REQUIRED BY SPECIAL INTERFACE 
CMR SR3,=Z'83C0! IF If IS THE END OF THE ROAD... 
BE >SKIP 
* $B3 <- PTR TO FIRST ARGUMENT AND 
* a $R3 <- ITS LENGHT (IN BYTES) 
LDB $B4,+SBl $B4 <- PTR TO 2ND ARG, OR NULL 
LDR SR4,+SB4 SR4 <- ITS LENTHG (OR X'83C0') 
*x 
SKIP EQU S 
* 
*** RELEVENT REGISTER SET MAY BE: S$R1-SR4 AND SB1-SB4. 
* 
@ . STIP EE02 SPECIAL INTERFACE TIP EXAMPLE 1 - 
LDB SB5 ,<ZCHOMM+X'18' SB5 <- SCB PTR 
LNJ $B5,*$B5.S DART CALL TO DARTS 
DC Z'*BEO2! TIP ID 
: . 
LDB SB6 ,<ZHCOMM+X'18! SB6 <- SCB PTR (SET UP NEXT STIP) 
* 
@ STIP EE03,S DART SPECIAL INTERFACE TIP EXAMPLE 2 
LNJ $B5,*$B6.S DART CALL TO DARTS 
DC Z'EEO3! TIP ID 
* 
@ STRMRO =0 TERMINATE THE TASK 
LDR $R2,=0- SET $R2 TO COMPLETION STATUS 
MCL 
DC Xx'0103! TERMINATE WITHOUT MODIFYING START ADDRESS 
* 
RESV 64,A'T?! 
STACK EQU $ . THE STACK 
. RESV 1,A'TT! 
TEST: A Software Module With Predefined 


Figure C-l. 


TEST  -EQU 
* 


**k* ENTERED WITH $B4 --> TRB AND $B7 


* 


LDR 
LDB 
LDR 
LDB 
LDR 


*** RELEVENT REGISTER SET IS: $R1-$R3 


$ 


SR1,+5SB7 
SB2 ,+$B7 
SR2,+SB2 
$B3 ,+$B7 
$R3,+$B3 


Trace Points 


--> PARM BLOCK 


SR1 <- 
SB2 <- 
$R2 <- 
SB3 <- 
S$R3 <- 


COUNT OF PARMS (INCL BU NAME) 
PTR TO BU NAME 

ITS LENGTH (IN BYTES) 

PTR TO 1STARG (OR NULL) 

ITS LENGTH (OR X'83C0') 


AND $B2-$B4 AND $B7. 


GENERAL INTERFACE TIP 


Mie 


x 
ae 


* TIP ID EEO] COLLECTS TRB AND PRMBLK INFO .-... 
DEF EEO] 

| REG $R1 S$R2 $R3 S$B2 $B3 S$B4 SB7 

DAT S$B4 12 -L TRB 

| DAT SB7.-5 60 —-L PRMBLK 

END EEO] 

* 


* TIP ID EEO2 REPORTS ARG-l1 IF IT EXISTS 
* : . 
DEF EE02 | 

DAT $B3 $B3,-1 -L ARG-1 -M 10 
DAT $B3 $R3.-1 -L SAM ARG 

END EE02 

* 


* IMPOSE CONDITION TO INSURE IT DOES NOT EXECUTE WITHOUT ARG-1l 
* 


SCX EE0O2 S$R1*=1 
* 


* TIP ID EEOQ3 REPORTS BU_NAME 
* 
| DEF EEO3 
DAT $B2 $R2 -L BU NAME 
| END EEO3 


3 


-* NOW ACTIVATE ALL 3 
* 


ACT EE* 


Figure C-2. Trace Collection Specifications (TICS) for TIPs 
EEOQ1, EEO2, and EEO3. 


A SPECIFIC TICS EXAMPLE 


The TICS specification statements for TIP EEO02 (Figure C-2) 
are of some interest. The user context at that point for TIP 
EEO2, includes, in the $B3/SR3 register pair, the pointer to, and 
the range of the first argument in the OCL command, if it : 
exists. The contents of the $R3 register -equal those of $B3.-l. 
The two DAT arrays use dynamic ranging to address the same 
memory. The first array is subject to a 10-byte limit. fThe 
second array has an implicit 2000-byte limit. The imposed 
condition (SCX) set for TIP EEO2 ensures that it will not collect 
data unless the ae of parameters in the SR1l Poa pene is other 
than one, 


FORMATTED OUTPUT oo 
For each TIP, the output has a standard format (Figure C-3). 
The header line indicates the TIP id (in hexadecimal notation), 


the sequence number of the TIP's execution (in decimal notation), 
and the time poones 


c-3 74-01 


The next two lines display the SR and $B registers contents. 
These lines are apsent when no as was Pao cr co in the TICs 
definition. 


All selected data array entries at the TIP are sueeue in 
sequence on the succeeding lines. If no array entry was selected. 
in the TICS definition, the formatted output for the TIP is | 
complete at this stage. The entry number (1 through 4) and its 
label, if any, are at the left margin of the first line of 
output. Up to 32 bytes of the collected data array appear in 
hexadecimal notation. The right margin displays the ASCII 
Character equivalent of the data. Multiple lines of output 
result when the captured data exceeds 32 bytes of information. 


In Figure C-3, the absence of TIP EEO2's output, between EOL 
and EE03 (sequence 2), for the second execution demonstrates the 
Suppression of data collection due to the imposed condition 
evaluating to .FALSE. In the next sequence (third execution), 
TIP EEO2's output displays the truncation of the first DAT array 
‘brought about by setting the -M limit on data collection. 


Note that in the third execution, TIP EEO2 has a sequence 
label of 0002; TIP's EEO] and EEO3 have sequence labels of 0003. 
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TO-¥LZ0— 


TIP: EEQl SEQ:0001 
SB7: 21F8F SB4: 21F84 
$R3: 0008 $R2: 0009 
1) TRB 0000 8DE4 00C1 FFOL 
2) PRMBLK 0002 0002 1F91 0002 
2D4PF 4E45 2020 CCCC 
TIP: EEO2 SEQ:0001 
1) ARG-1 5041 524D 2D4F 4845 


2) SAM_ARG 5041 


TIP:EEO3 
1) BU_NAME 


SEQ:0001 
3E48 


524D 2D4F 4845 


4953 3854 4553 


TIP:EEO] SEQ:0002 
SB7: 21FAF $B4: 21FA4 
SR3: 83C0 S$R2: 0009 
1) TRB 0000 8DCC 00Cl1 FFO1 
2) PRMBLK 0001 0002 1FAF 0000 
Cccc C€cce Ccce CCCcCc 
TIP: EEO3 SEQ:0002 


1) BU_NAME 3848 


4953 3E54 4553 


0002 1F93 0002 1F9B 0002 1F9F 0000 0000 0000 
0005 5445 5252 5920 0007 4245 4E54 4C45 5920 


TIP:EEO1 SEQ:0003 
SB7: 21F8F SB4: 21F84 
SR3: OO1E S$R2: OOOD 
1) TRB 0000 8DFC 00Cl1 FFOI] 
2)  PRMBLK 0002 0002 1F91 0002 
5041 524D 2D4F 4E45 
TIP:EEO2 SEQ:0002 
1) ARG-1l 5041 524D 2D4F 4E45 
2) SAM_ARG 5041 524D 2D4F 4E45 
TIP:EEO3 SEQ:0003 
1) BU NAME 3E53 5953 4C49 4231 
TIP:EEO] SEQ:0004 
$B7: 21F8F S$B4: 21F84 
SR3: 0005 SR2: 
1) TRB 0000 0760 00Cl FFO1 
2) PRMBLK 0003 
5420 
TIP:EEO02 SEQ:0003 
1) ARG-1 5445 5252 5920. 
2) SAM_ARG 5445 5252 5920 
TIP:EE03. SEQ:0004 
1) BU_NAME 3E53 5953 4C49 4231 


TIP:0007 SEQ:0001 


TIME: 1985/07/19 1200:56.500 


$B3: 21F9B $B2: 21F92 
SR1: 0002 
cccce CCCC 


1F97 0000 0000 0009 3E48 4953 35654 4553 5420 0008 5041 524D 
ecce cece cccee ccce Cccce CCccc CCccce Cccce cccc CCCC 


TIME: 1985/07/19 1200:56.500 


TIME: 1985/07/19 1200:56.500 


9420 

TIME: 1985/07/19 1201:03.500 
$B3: 00001 $B2: 21FBO0 

SR1: 0001 

cccce CCCC 


0000 0009 3E48 4953 3E54 4553 
cece CCcc 0006 0000 0000 0000 


TIME: 1985/07/19 1201:03.500 


5420 


TIME: 1985/07/19 1201:25.850 


$B3: 21F9A $B2: 21F92 
SR1: 0002 
CCCC CCCC 


1F99 0000 0000 O000D 3E53 5953 
2D49 532D 4D4F 5245 2D54 4841 


TIME: 1985/07/19 1201:25.900 


2D49 


2D49 532D 4D4F 5245 2D54 4841 


TIME: 1985/07/19 1201:25.900 


3E54 4553 5420 


TIME: 1985/07/19 1201:57.450 


SB3: 21F9C $B2: 21F94 


Q0OD $R1:0003 


cccce CCCCc 


TIME: 1985/07/19 1201:57.500 


TIME: 1985/07/19 1201:57.500 


3E54 4553 5420 


TIME: 1985/07/19 1202:05.850 


5420 
CCCC 


4C49 
4E2D 


4E2D 


3E53 
0102 


0102 0002 
ecce Ccce 


4231 3E54 
3130 2D42 


3130 2D42 


5953 4C49 
0002 1F84 


1FA4 
CCcc 


4553 
5954 


9954 


4231 
0002 


0002 2054 


5420 OO1E 


4553 


3E54 4553 


---D,A..-LLLL 2 
CREPE G NORA SREP OLOO LEST - « PARM 
-ONE LLLLLLLLLLLLLLLLLLLLLL 


PARM-ONE 
PARM~ONE 


P>HIS>TEST 


»--L.A..LLLL 
éewaal <*ees<2HIS> Test Porat. rae D 
LLLLLLLLLLLL........+LLLLLLLL 


>HIS>TEST 
bea he Ree bub 


coc ccveesesenesPOLOUIBLOTEST .. 
PARM-ONE~ IS-NORE-THAN-10-BYT 


PARM-ONE~TI 
PARM~ONE- IS~MORE-THAN~10-BYTES 


>SYSLIBLOTEST 
--- @.A..LLLL 


éK¢k wa 6 0 ON aS Oe w SRS P DL OULBIOTES 
T ..TERRY ..BENTLEY ...cceees 


TERRY 
TERRY 


>SYSLIB1>TEST 


Figure C-3. Collected Trace Data as Formatted by the 
Log File Formatter. 
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GLOSSARY 


Active TIP 


An explicitly activated TIP that is capable of collecting 
data when encountered (executed), 


Buffers 
Internal Buffers. 
Buffer Logger 


Nondistributed component of DARTS that outputs buffers 
(passed from the data collector) to the online Log File, 


Buffer Manager 
Nondistributed component of DARTS that maintains the chain of 
internal buffers. The task operates in tandem with the buffer 
logger. | 

Command 
Issued at initialization (from the aes base file) or. 


subsequently by the operator to control the execution of 
DARTS. Some commands can be issued only by the operator. 


g-l 7 4-01 


“Command Manager 
Component of DARTS that accepts and parses interactive input 


from the operator and schedules the appropriate command 
processor, | | | 


Command Processor 
Component of DARTS that performs the action of a particular 


command. Scheduled from either the command manager or the 
command file processor. | 


Distributed component of DARTS that is responsible for data 
collection at a TIP. It passes internal buffers (filled with 
the data collected at various TIPs) to the buffer logger, 

Formatter 
Log file formatter, 

General Interface 
One of two ways to define a TIP, by using the trace 
instruction to generate a trap that in turn leads to the data 
collector, Available to both system level and user level 
software modules. 

Inactive TIP 
The initial state of a TIP, when it is incapable of 
collecting data. A TIP has to be explicitly activated for 
use, | 

Internal Buffers 
Memory blocks of specified size and (initial) number, 
maintained in a chain, that serve as the recording medium for 
the data collector. | 

Link-and-Jump Interface 
Special Interface. 

Log File 


An online disk file to which the buffer rodget Our EUEe: 
buffers as with collecting data. 
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Log File Formatter 


Spawned task component of DARTS that processes the 
information in a log file (online or offline)... 


Logger 
Buffer logger. 

Module Code 
The left pair of hexadecimal digits in a 4-digit hexadecimal 
TIP id. A unique code that is preassigned for each software 
module, with different TIPs in a module having different site 
codes. The Module code of 00 is reserved for the exclusive 
use of the DARTS facility. 

Pre-defined TIP 
A permanent TIP that is assembled inline by the developer of 
a software module, to provide a standard data collection site 
in released software. | 

Site Code 
The right paix of hexadecimal digits in a 4-digit hexadecimal 
TIP id. Used to identify a TIP definition in a specific 
module. 

Special Interface 


One of two ways to define a TIP, with a link-and-jump call to 
the data collector. Available only to system level modules, 


SCB 
System Control Block. 

Trace Information Capture Specification 
Structure that defines the user register context and/or user 
‘data arrays to be collected at a TIP. This structure is 
under the control of DARTS and is external to the software in 
which the TIP is defined. 


Trace Information Point 


A calling sequence in the user software that marks the site 
for information collected. 


Trap Interface 


General interface, 


g-3 274-01 


Trap Processor | | = 
Special routine to process ‘he: eae. eon tie: Space: 
instruction that serves as the interface to the data 
collector. 

TICS 
Trace Information Capture Specification. 

TIP 
Trace Information Point. 

TIP id 
A 4-digit hexadecimal (16-bit) number that uniquely | 
identifies a TIP. The left pair of digits is interpreted as 
the module code, and the right pair is interpreted as the 
site code, i | 

User Data Array 
An array of data words/bytes that is collected at a TIP 
according to the specification in the TICS structure. The 
specification is represented by an entry in the TICS 
structure, 


User Register Context 


The execution context of the DARTS user, preserved across the 


call to the trace facility that can itself be collected 
and/or used in data collection at a TIP. 
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ZOOS 


INDEX 


Abort TICS Definition (ABT) 
Defined, 4-9 


Aborting a Defined TICS. (REM) , 
4-15 


Aborting TICS 
Def inition-in-progress 
(ABT), 4-15 
vs Removing a TICS, 
4-15, 4-25 


4-9 f 


ABT 
Abort TICS Definition 
(ABT), 4-9 
Aborting TICS 
Definition-in-progress 
(ABT), 4-15 


Activate TICS (ACT), 4-10 
Allocating Buffers, 4-11 
BFR 

Buffer Pool (BFR), 4-11 


Buffer Pool (BFR), 4-11 


Buffer Pool Commands, 4-7 


Buffer Size, 4-11 
Command 
Execution, 
Format, 1-2 
Manager, 2-3 
Processors, 2-3 
Issued From Console, 2-l, 
4-5 
Sources Of, 


4-5 


4-5 


Configuration Component, 3-1 


Continuation Character (&) 
User Commands, 4-5 


DAT 
Data Array Definition 
(DAT), 4-12 


Data 


Data Array Address, 4-12 


Array Range, 4-12 


Data Array Definition (DAT), 
4-12 


Data Arrays 
Number per TICS, 4-12 


Data Base File 
Description, 2-3, 3-3 
Initialization Data Base 

File, 1-2, B-l 
Recommendations, B-l 
Data Buffer Logger, 2-4 


Data Buffer Manager, 2-3 


Data Collector, 2-2 
Data Collector, 2-3 
Logging Function, 2-2 


DBF 
Display Buffer Pool Status 
(DBF), 4-15 
DEA 
Deactivate TICS (DEA), 4-14 


Deactivate TICS (DEA), 4-14 


DEF 
Define TICS (DEF), 4-15 


Define TICS (DEF), 4-15 


Definition Commands 
Listed 4-6 


Display Buffer Pool Status 


Display TICS Attributes enor 
4-17 


Stip | 
Description, 4-2 
Stip With Stipsp, 4-3 
Stip Without Stipsp, 4-2 
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INDEX 


DTC 
Display TICS Attributes 
(DTC), 4-17 


Echo Option (XEC), 4-19 


ECL Command Executing LOG File 
Formatter, 5-1 


END 
End TICS Definition (END) , 
4-18 


End TICS Def inition (END) , 
4-18 


Error Messages 
Example, A-1l 


Execute Command File (XEC), 
4-19 — 


FMT 
Format Logged Data (FMT), 
2 a 
Format Logged Data (FMT), 5-3 


Formatted Data 


Time Window, 5-3 


Formatter Commands, 5-3 
Listed, 4-7 

General Commands, 4-8 

General Interface, 2-3 

General TIP Interface, 4-2 

Glossary, g-l 

Help Messages, 4-5 


Information Messages 


i-2 


Initialization. 7 
DARTS ini eal ization: 
Description, 3-1 
Command, 3-2 | 
Data Base File, 1-2, 
From Data Base, as | 


i=], 
B-1 


Interactive Commands, » ‘A—6, 
4-7 


Interactive Echo Option (XEC), 
4-19 


Internal Buffers, 2-1 


Link-and-jump Interface, 2-3 


LOG 
Log File Definition (LOG), 
4-22 


Log File Formatter 
Description, 5-1 
ECL Command Execution, 5-1 
Example (Figure C-3), C-4 
Executed From User Task 


4ttéec Outpuc, 5-2 


File Definition (LOG), 


Logger Control Commands, 4-7 


Macros 
Stipsp Stip, 4-2 
Stip With $tipsp, 4-3 
Stip Without Stipsp, 4-2 


Manipulation Commands, 4-6 


Module Codes, 4-4 

Number of Buffers, 4-11 

OCL | 
DARTS Invoked by OCL, 2-2 
Description, 2-2, 4-1 
Examples, C-l 
Terminate Logging using OCL 

Command, 4-33 
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Offset 
Stip Macro, 4-3 
DARTS Commands, 4-12, 4-32 
Pre-defined TIPs 
Description, 4-4 


RCX 
Reset Condition for 
Execution (RCX), 4-26 


REG : 
Register Set Definition 
(REG), 4-23 


Register Set Definition (REG), 
4-23 


Registers 
SB SR, 4-12, 4-23, 5-2 
SI SM1, 4-23 
Use of, 4-12 


REM 
Aborting vs Removing a TICS, 
4-9, 4-15 
Remove TICS Definition 
(REM), 4-25 


Remove TICS Definition (REM), 
4-25 


Removing vs Aborting a TICS, 
4-9, 4-15, 4-25 


Reset Condition for Execution 
(RCX) , 4-26 


Resume Formatting (RFM), 5-5 
Resume Logging (RLG), 4-28 
REM 
Resume Formatting (RFM), 
5-5 
Ring 0, 2-3, 4-2, C-1 


RLG 
Resume Logging (RLG), 4-28 


INDEX 


S DART (SCB Offset), 4-3 
S DINF (SCB Offset), 3-1 
SCB, 3-1, 4-3 
SCX 
Set Condition for Execution 
(SCX), 4-29 


Set Condition for Execution 
(SCX), 4-29 


SFM 
Suspend Formatting (SFM), 
5-6 


SID 
Directory, 2-2 


Site Codes, 4-4 


SLG 
Suspend Logging (SLG), 4-33 


Special Interface, 2-3 


Special TIP Interface, 4-2, 
4-3 


Suspend Formatting (SFM), 5-6 
Suspend Logging (SLG), 4-33 
System Control Block, 3-1, 4-3 


System Pool ($$), 2-2, 4-2, 
C-] 


System Tasks, 4-2 


Table Of Entries for TICS 
(TOE) , 4-35 


Terminate Formatter (TFM), 5-7 


Terminate Logging 
Description, 4-33 : 
Using OCL Command Only, 

4-33 
vs Suspend Logging, 4-33 
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Terminating DARTS, 3-3 


TFM | 
Terminate Formatter (TEM) , 
5-7 


TICS | 
Definition Commands, 4-6 
Examples Figure C-2, C-3 
Manipulation Commands, 4-6 
Necessary Specifications, 
4-15 


Time Window (FMT), 5-3 


LP 
DARTS TIP, 2-1 
General TIP Interface, 4-2 
Module Codes, 4-4 
Special TIP Interface, 4-3 
Id, 2-2, 4-4 
Identification Code, 4-4 
Module Codes, 4-4 
Pre-defined, 2-2 
Site Codes, 4-4 
Software Example, C-2 
User TIP Interface, 4-1, 

4-2 


Stip 
Description, 4-2 
Stip With Stipsp, 4-3 
Stip Without Stipsp, 4-2 


TOE 
Table Of Entries for TICS 
(TOE), 4-35 


Trace Information Capture 
Specification, 1-1, 2-1, 4-6 
(see TICS) 


Trace Information Point, 1l-l, 
2-1 (see TIP) 
User TIP Interface, 4-l, 4-2 


| User Command Interface, 4-l, 
4-5 


“INDEX 


1-4 


User Gonrands | 
Comment (*),°4- 8. 


Continuation Character (8), 


4-5 


Description, 4-6, 4-7 


User Interface(s), 2-3, 4-1 
User TIP Interface, 4-1, 4-2 
Wildcard TIP, 4-10 | 
XEC 
DARTS via XEC Commands, 
2-3, 4-5, 4-9 


Execute Command File (XEC), 
4-19 
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